package org.dromara.workflow.flowable.cmd;

import org.dromara.common.core.utils.StreamUtils;
import org.flowable.common.engine.impl.interceptor.Command;
import org.flowable.common.engine.impl.interceptor.CommandContext;
import org.flowable.engine.impl.persistence.entity.ExecutionEntity;
import org.flowable.engine.impl.persistence.entity.ExecutionEntityManager;
import org.flowable.engine.impl.util.CommandContextUtil;

import java.io.Serializable;
import java.util.List;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：获取并行网关执行后保留的执行实例数据
 */
/**
 * 根据执行ID获取子执行实例的命令类
 * 该命令实现了Command接口，返回值类型为ExecutionEntity的列表
 * 主要用于在流程引擎中，根据特定的执行ID查询相关的子执行实例
 */
public class ExecutionChildByExecutionIdCmd implements Command<List<ExecutionEntity>>, Serializable {

    /**
     * 当前任务执行实例id
     */
    private final String executionId;

    /**
     * 构造函数注释块
     *
     * ExecutionChildByExecutionIdCmd类的构造函数，用于初始化执行对象的ID
     *
     * @param executionId 执行对象的ID，用于标识特定的执行实例
     */
    public ExecutionChildByExecutionIdCmd(String executionId) {
        this.executionId = executionId;
    }

    /**
     * 重写execute方法，以实现特定的执行逻辑
     * 主要用于查询指定执行数据的所有非活动子执行数据
     *
     * @param commandContext 命令上下文，提供执行操作所需的环境信息
     * @return 返回所有非活动的子执行实体列表
     */
    @Override
    public List<ExecutionEntity> execute(CommandContext commandContext) {
        // 获取执行实体管理器
        ExecutionEntityManager executionEntityManager = CommandContextUtil.getExecutionEntityManager();
        // 获取当前执行数据
        ExecutionEntity executionEntity = executionEntityManager.findById(executionId);
        // 通过当前执行数据的父执行，查询所有子执行数据
        List<ExecutionEntity> allChildrenExecution =
            executionEntityManager.collectChildren(executionEntity.getParent());
        // 返回所有非活动的子执行实体
        return StreamUtils.filter(allChildrenExecution, e -> !e.isActive());
    }
}
